home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / misc / splines.lha / Splines / README.POPMENU < prev    next >
Encoding:
Text File  |  1987-09-02  |  2.2 KB  |  71 lines
  1.                         Using PopUp Menus
  2.  
  3. files: popup_menu.h,  popup_menu.c
  4.              
  5. Initializing the PopUp Menu Package:
  6.   
  7.   - make sure your program has opened the Intuition, Graphics, Layers
  8.     libraries
  9.  
  10.   - call Init_MenuPackage
  11.  
  12.   - if Init_MenuPackage returns FALSE, something went wrong so don't
  13.     use the menu package ...exit while you can
  14.   
  15.   - create your popup menus (see below)
  16.  
  17.   - make sure that your window asks Intution to update its
  18.     MouseX and MouseY coordinates by setting REPORTMOUSE flag in
  19.     your window or calling ReportMouse(Window, TRUE).
  20.  
  21.  - set the MOUSEBUTTONS IDCMP flag in your window structure so that
  22.    your program will be notified when the mouse buttons are pressed.
  23.  
  24.  - if you want your popup menu to be activated on a right mouse button,
  25.    make sure that you set the RMBTRAP flag in your window
  26.            
  27.  
  28. Creating a PopUp Menu:
  29.  
  30.    - initialize a PopUp_Menu structure
  31.  
  32.    - call Init_PopUp_Menu
  33.  
  34.    - if Init_PopUp_Menu returns FALSE, the initialization routine failed
  35.      so don't use the popup menu
  36.  
  37.  
  38. Popping Up a Menu:
  39.  
  40.    - wherever you receive your IDCMP messages, check for the
  41.      MOUSEBUTTONS event and if the IDCMP message contains the
  42.      Code to select your menu (SELECTDOWN if you want your menu
  43.      activated on left mouse button, MENUDOWN for right mouse
  44.      button) then...
  45.  
  46.    - call PopUp with the menu that you want to appear and the window
  47.      that you want it to appear on. The menu will appear under the
  48.      window's current mouse position.
  49.    
  50.    - PopUp will return when the user has deactivated the menu.  PopUp
  51.      will return the selection_id of the item the user has selected.
  52.      If no item was selected when the menu was deactivated then PopUp
  53.      will return NOITEM_SELECTED.  If the cursor was outside of the
  54.      window, PopUp will return OUTSIDE_WINDOW.  Note: selection_ids
  55.      should be >= 0 so that they don't conflict with NOITEM_SELECTED
  56.      or OUTSIDE_WINDOW.
  57.      
  58.  
  59. Closing Everything:
  60.  
  61.     To ensure that all of the memory consumed by your popup menus
  62.     (and the popup menu package itself) is released, you should:
  63.  
  64.    - call Dispose_PopUp with each popup menu that you have initialized
  65.  
  66.    - call Close_Menu_Package
  67.  
  68.  
  69. BUGS: doesn't support GIMMEZEROZERO windows
  70.  
  71.